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Wichtig: Dieses Gerat arbeitet mit Hochfrequenz und 
kann Radio- oder Fernsehempfang st6ren, wenn es nicht 
strikt nach dieser Anleitung installiert und benutzt wird. Es 
entspricht den Vorschriften, die einen st6rungsfreien Be- 
trieb im hauslichen Bereich sichern. Es kann jedoch keine 
Garantie bernommen werden, daB Stérungen in be- 
stimmten Konfigurationen auftreten. Wenn trotzdem bei 
Innen Radio- oder Fernsehempfang gestdért werden, stel- 
len Sie zunachst fest, ob es wirklich an diesem Geratliegt, 
indem Sie es aus- und wieder einschalten und solange die 
Empfangsstorung beobachten. Falls es tatsachlich an 
diesem Gerat liegt, Knnen Sie folgende AbhilfemaBnah- 
men selbst versuchen: 

Empfangsantenne von Radio/Fernseher exakt ausrich- 
ten 

Monitor weiter entfernt vom Empfanger aufstellen 
Ganze Computeranlage weiter weg vom Empfanger auf- 
stellen 

Gerate an verschiedene Stromkreise anschlieBen, um 
Eindringen von St6érungen Uber Netzzuleitungen zu er- 
schweren. 


Weitere Hilfe konnen Sie beim Computer-Fachhandler oder im 
Radio/Fernseh-Fachhandel finden. 


Erste Auflage, November 1986 
Copyright 1986 by Commodore Buromaschinen GmbH 


Dieses Handbuch enthalt nach dem Urheberrecht geschttzte 
Information, es darf auch auszugsweise nicht kopiert oder in 
irgendeiner Form ubertragen werden ohne ausdruckliche 
Genehmigung von Commodore Buromaschinen GmbH. 


Commodore-Maus 1351 ist eingetragenes Warenzeichen von 
Commodore Buromaschinen GmbH 
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Commodore 64 und Commodore 128 sind eingetragene 
Warenzeichen von Commodore Buromaschinen GmbH 


GEOS ist eingetragenes Warenzeichen 
von Berkeley Softworks 
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Uber dieses Handbuch 


Dieses Handbuch gliedert sich in zwei Teile. Der erste behan- 
delt nach einer Einfuhrung die Reinigung und Pflege der Maus. 
Dieser Teil gilt Benutzern mit schon Maus-kompatibler Soft- 
ware, die die Maus einfach anschlieBen und benutzen wollen. 
Der zweite Teil des Handbuchs enthait Informationen fur dieje- 
nigen, die Software fur die Maus entwickeln wollen. 

Die Listings sind hier in der englischen Originalfassung belas- 
sen worden. 
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Erster Teil 


Einfuhrung 

Die Commodore-Maus 1351 ist ein Eingabegerat, das fur den 
Einsatz am Commodore 64 oder Commodore 128 konzipiert 
ist. Sie bietet zwei Tasten auf der Oberseite und eine Kugel auf 
der Unterseite, die bei Bewegung der Maus auf einer ebenen 
Oberflache mitrollt und dabei richtungsmaBig entsprechende 
Bildschirmaktivitaten ausl6sen kann. 


Die Maus arbeitet in zwei Betriebsarten: dem Joystickmodus 
und dem Proportionalmodus. 


Im Joystickmodus bildet die Maus einen Joystick nach und 
kann mit Joystick-kompatibler Software betrieben werden. 


Im Proportionalmodus wird ein neues Ubermittlungsverfahren 
fur Mausbewegungen an die Steuersoftware verwendet. Das 
bedingt spezielle Software, die die Maus erkennt und deren 
Impulse korrekt verarbeitet. Z.B. kann das GEOS-Betriebs- 
system Treiber fur mehrere Eingabegerate aktivieren. Einer 
von ihnen ist der Commodore-Maus-Treiber, der die 1351 im 
Proportionalmodus betreibt. 


Der Proportionalmodus der 1351 ermdglicht es, einen 
Mauspfeil reaktionsschnell und prazise auf dem Bildschirm zu 
bewegen. Der Joystickmodus bleibt als Reserve flir solche 
Anwendungsprogramme, die die aktivierten Eingabe-Treiber 
nicht verwenden. Damit kann man die Maus fur altere Software 
als Joystick benutzen und kann trotzdem die Vorteile des Pro- 
portionalmodus bei neuerer Software genieBen. 


Beim Einschalten des Stroms ist die Maus automatisch im Pro- 
portionalmodus. Soll sie im Joystickmodus betrieben werden, 
verbinden Sie sie mit dem Computer und halten beim Ein- 
schalten die rechte Maustaste fest. 
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Reinigung der Maus 

Die Kugel auf der Maus-Unterseite muB frei Uber die Tisch- 
Oberflache rollen kénnen, um den Cursor oder Mauspfeil pra- 
zise zu steuern. Dazu muB sie von Staub und Fusseln befreit 
werden, wann immer sich welcher festgesetzt hat. Dazu dre- 
hen Sie die Mus um und schieben die Plastik-Abdeckung bei- 
seite, die die Kugel am Herausfallen hindert. 


Entnehmen Sie die Kugel und wischen Sie sie mit einem wei- 
chen, fusselfreien Tuch sauber, benutzen Sie keine Flussig- 
keit! 
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In der jetzt freien Kugel-Offnung des Maus-Gehauses kann 
sich auch Staub angesetzt haben, pusten Sie ihn kraftig weg. 
Um die Offnung herum sehen Sie drei kleine Metallrollen. Wi- 
schen Sie jede mit einem Wattetupfer und etwas Alkohol oder 
Tonkopfreiniger sauber. Drehen Sie dabei die Rollen, um ihre 
ganze Oberflache zu reinigen. Legen Sie danach die Kugel 
wieder ein und schlieBen Sie die Abdeckplatte, die deutlich 
einrasten soll. 


Behandlung der Maus 


Beachten Sie ganz normale Umgangsregeln mit empfind- 
lichen technischen Geraten. 


Benutzen Sie die Maus nur auf sauberen, glatten Oberflachen. 


Schaffen Sie sich genug Platz auf dem Tisch fur die Maus, 
dann mussen Sie sie nicht standig anheben und neu ansetzen. 


Halten Sie die Maus nicht am Kabel fest und lassen Sie sie 
auch nicht am Kabel vom Tisch herunterhangen. 
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Zweiter Teil — Entwicklerhinweise zum 
Proportionalmodus 


Dieser Handbuchteil erklart die Funktion des Proportionalmo- 
dus der Commodore-Maus 1351 und schlagt Software-Ver- 
fahren zu ihrer Ansteuerung vor. 


Einfihrung 


Die Commodore-Maus 1351 ist zum Gebrauch am Commodo- 
re 64/128 bestimmt, ist mit zwei Drucktasten ausgestattet und 
kann an eine der Joystick-Buchsen des C 64/128 angeschlos- 
sen werden. 


Die Maus kennt zwei Betriebsarten: 
1) Joystickmodus, 2) Proportionalmodus. 


Der Proportionalmodus ist mit dem C 64 und dem C 128 ver- 
wendbar und braucht ein spezielles Treiberprogramm in 
‘Maschinensprache, um die volle Leistungsfahigkeit zu entfal- 
ten. : 


Die Betriebsart wird beim Stromeinschalten festgelegt. Wenn 
der Benutzer dabei die rechte Maustaste gedrtckt festhalt, 
gelangt die Maus in den Joystickmodus. Wird die rechte Maus- 
taste beim Einschalten nicht betatigt, gelangt die Maus stan- 
dardmaBig in den Proportionalmodus. 


Der Joystickmodus wird als Reserve’ zur Verfugung gestellt, 
falls die verwendete Software den Proportionalmodus nicht 
verarbeiten kann. 


Joystick-Modus 
Im Joystickmodus arbeitet die Maus wie folgt: 


1) Bei einer Bewegung der Maus werden die entsprechenden 
Joystick-Kontakte alle 20 ms betatigt. So entspricht die Be- 
wegung der Maus einem Drucken des Joysticks in die ent- 
sprechende Richtung. 
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2) Die linke Maustaste fungiert als Feuerknopf des Joysticks. 


3) Die rechte Maustaste ist mit dem SID-POTX-Eingang ver- 
bunden. Bei Betatigung enthalt dieses Register einen Wert 
von unter $ 80 (0-127), solange die Taste nicht gedriickt ist, 
einen Wert ab $ 80 (128-255). 


4) Bitte auch Abschnitt SID-REGISTER-HINWEISE beachten. 


Software-Schnittstelle im Joystickmodus 


Bei den meisten Anwendungen sollte die Software-Schnitt- 
stelle fur den Joystickmodus wie bei einem normalen Joystick- 
Treiber beschaffen sein und die rechte Maustaste ignorieren. 


Proportionalmodus 
Im Proportionalmodus arbeitet die Maus wie foigt: 


1) Jede Bewegung wird innerhalb der Maus registriert. Die ak- 
tuelle Position wird modulo 64 alle 512 Mikrosekunden an 
die SID-Register POTX und POTY Ubertragen, ohne daB 
eine Software dazu nétig ist. Das Register POTX gibt die 
x-Position und das POTY-Register die y-Position der Maus 
wieder. 


Registerbelegung: 
Bit-Position (7/6[5/4/3/2/1]0) 
POT-Register |X [P5|P4/P3/P2|P1|PO| N | 
wobei: , 
Ke -sbvuncveaavaiia nicht verwendetes Bit 
PS=PO. cccassous Mausposition modulo 64 
Naa ttewnreias spezielles (Rausch-) Bit (s.u.) 


2) Die linke Maustaste ist wie ein Joystick-Feuerknopf ange- 
schlossen. 


3) Die rechte Maustaste ist am Kontakt fur die Aufwartsrich- 
tung des Joysticks angeschlossen. 
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Software-Schnittstelle im Proportionalmodus 


1) Da linke und rechte Maustaste wie Joystick-Kontakte funk- 
tionieren, erfolgt die Abfrage als einfache ’Polling’-Ubung. 


Beachten Sie, da8 wie beim Joystick scheinbar die normale 
Tastatur betatigt wird. Die Software sollte etwas Muhe dar- 
auf verwenden, zwischen einem KurzschluB in der Tasta- 
tur-Matrix (gedruckte Taste) und einer komplett geerdeten 
Matrix-Zeile (Joystick-artiges Signal) zu unterscheiden. 


2) Die Positions-Information ist leicht zu handhaben. Am be- 
sten geschieht das in der 50/60-Hz-Interrupt-Routine (vor- 
zugsweise am Anfang, s.u. bei SID-REGISTER-HIN- 
WEISE). 


Man geht wie folgt vor: 
1) Mausposition modulo 64 auslesen. 
2) Die Position mit der gespeicherten vorigen vergleichen. 


3) Wenn die Maus bewegt wurde, andern Sie Ihre Pfeil-Po- 
sition entsprechend. 
Die Maus hat einiges damit zu tun, ihre Position in die 
SID-Register zu Ubertragen. Leider ist dabei ein Bit un- 
bestimmt (Rauschen). Beispiel: Selost wenn die Maus 
ruht, kann ein POT-Register zwischen $ 80 und $ 7F 
schwanken. Das wurde zu einem Zittern der Maus um ei- 
ne Punktbreite fuhren. Es ist daher ndtig, das niedrigste 
Bit der POT-Register zu betrachten, bevor man eine Ent- 
scheidung fallt, ob und in welche Richtung sich die Maus 
bewegt hat. 


Dies alles k6nnen Sie in den folgenden Listings des 
Maustreiber-Programms berucksichtigt wiederfinden. 
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SID-Register-Hinweise 

Im C 64 und C 128 sind die SID-Potentiometer-Anschliisse an 
beide Joystick-Buchsen gefuhrt. Ein Analogschalter 4066 
schaltet die POT-Leitungen zwischen den beiden Buchsen um 
auf eine der Tastatur-Matrix-Leitungen. Dadurch beeinfluBt 
der normale Tastatur-Scan-Interrupt zeitweise die Werte der 
POT-Register. Daher mussen im Sinne einer verlaBlichen 
Datenerfassung die POT-Leitungen mindestens fir 1,6 ms an- 
liegen, bevor die Daten im POT-Register gultig werden. 


Der beste Weg dies sicherzustellen ist, die Treiber-Software in 
die IRQ-Routine einzuklinken vor der Tastatur-Abfrage. Das 
sichert mehr oder weniger, daB die Tastatur-Matrix-Leitungen 
einen stabilen Zustand angenommen haben, bevor das POT- 
Register vom Maus-Treiber ausgelesen wird. 
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Software-Schnittstelle im Proportionalmodus 


1) Da linke ‘und rechte Maustaste wie Joystick-Kontakte funk- 
tionieren, erfolgt die Abfrage als einfache ’Polling’-Ubung. 


Beachten Sie, daB wie beim Joystick scheinbar die normale 
Tastatur betatigt wird. Die Software sollte etwas Mthe dar- 
auf verwenden, zwischen einem Kurzschiu8 in der Tasta- 
tur-Matrix (gedruckte Taste) und einer komplett geerdeten 
Matrix-Zeile (Joystick-artiges Signal) zu unterscheiden. 


2) Die Positions-Information ist leicht zu handhaben. Am 
besten geschieht das in der 50/60-Hz-Interrupt-Routine 
(vorzugsweise am Anfang, s.u. bei SID-REGISTER- 
HINWEISE). 


Man geht wie folgt vor: 
1) Mausposition modulo 64 auslesen. 
2) Die Position mit der gespeicherten vorigen vergleichen. 


3) Wenn die Maus bewegt wurde, andern Sie Ihre Pfeil- 
Position entsprechend. 
Die Maus hat einiges damit zu tun, ihre Position in die 
SID-Register zu Ubertragen. Leider ist dabei ein Bit un- 
bestimmt (Rauschen). Beispiel: Selbst wenn die Maus 
ruht, kann ein POT-Register zwischen $ 80 und $ 7F 
schwanken. Das wurde zu einem Zittern der Maus um 
eine Punktbreite fuhren. Es ist daher notig, das niedrigste 
Bit der POT-Register zu betrachten, bevor man eine Ent- 
scheidung failt, ob und in welche Richtung sich die Maus 
bewegt hat. 


Dies alles kénnen Sie in den folgenden Listings des 
Maustreiber-Programms bertcksichtigt wiederfinden. 
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SID-Register-Hinweise 

Im C 64 und C 128 sind die SID-Potentiometer-Anschlisse an 
beide Joystick-Buchsen gefihrt. Ein Analogschalter 4066 
schaltet die POT-Leitungen zwischen den beiden Buchsen um 
auf eine der Tastatur-Matrix-Leitungen. Dadurch beeinfluBt 
der normale Tastatur-Scan-Interrupt zeitweise die Werte der 
POT-Register. Daher mlssen im Sinne einer verlaBlichen 
Datenerfassung die POT-Leitungen mindestens fur 1,6 ms 
anliegen, bevor die Daten im POT-Register giiltig werden. 


Der beste Weg dies sicherzustellen ist, die Treiber-Software in 
die IRQ-Routine einzuklinken vor der Tastatur-Abfrage. Das 
sichert mehr oder weniger, da@ die Tastatur-Matrix-Leitungen 
einen stabilen Zustand angenommen haben, bevor das POT- 
Register vom Maus-Treiber ausgelesen wird. 
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Guide D’Utilisation 
de la souris 1351 


Avec les ordinateurs 
Commodore C 64°, 
C 64 C” et C 128" 
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Premiére impression, septembre 1986 
Copyright ° 1986 Commodore Electronics Limited 
Tous droits réservés 


Rien de cette publication ne peut étre reproduit, enregistreé 
dans un systéme de recherche documentaire ou transmis 
sous quelque forme ou par quelque moyen que ce soit, par 
voie électronique, mécanique de photocopie, d’enregistre- 
ment magnétique ou de toute autre maniére, sans |’autorisa- 
tion écrite préalable de Commodore France. 


La souris Commodore 1351 est une marque déposée de 
Commodore Electronics Limited. 


Commodore 128 est une marque déposée de Commodore 
Electronics Limited. 


Commodore et Commodore 64 sont les marques déposées de 
Commodore Electronics Limited. 


GEOS est une marque déposée de Berkeley Softworks. 
Traduction de Commodore France. 


Copyright® 1986 Commodore Electronics Limited. 
Tous droits réservés. 
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Au sujet de ce manuel 


Ce manuel est divisé en deux parties. La premiére partie com- 
prend l’introduction, l’entretien de la souris et les conseils d’uti- 
lisation de la souris. Cette partie est destinée a!’utilisateur d’un 
logiciel compatible-souris, qui désire connecter la souris et 
commencer a lutiliser. La seconde partie du manuel contient 
des informations destinées aux développeurs de logiciel avec 
souris. 


Introduction 


La souris Commodore 1351™ est une interface créée pour étre 
utilisée avec les ordinateurs Commodore 64° ou Commodore 
128”. Elle a deux boutons dessus et une boule dessous qui 
doit rouler sur une surface plate pour engendrer une action a 
’écran. 

Cette souris a deux modes opératoires : le mode manette de 
jeu (joystick) et le mode proportionnel. 


En mode manette de jeu, la souris mule une manette de jeu et 
peut étre utilisée avec les logiciels compatibles-manettes de 
jeux. Dans ce mode, le bouton de gauche est le bouton de tir et 
le bouton de droite est généralement inactif. 


En mode proportionnel, la souris utilise une nouvelle techni- 
que pour transmettre son mouvement au logiciel qui contrdle 
l'application. I faut pour cela que le logiciel reconnaisse la sou- 
ris et quil puisse lire sa position. Par exemple, le systéme d’ex- 
ploitation GEOS”™ peut utiliser des gestionnaires d’entrée dif- 
férents. Lun d’entre eux est la souris Commodore, qui peut 
étre utilisée avec la 1351 en mode proportionnel. 


La 1351 utilise le mode proportionnel pour que les applications 
aient un curseur rapide et maniable. Le mode manette de jeu 
ralentit les applications qui nont pas de gestionnaire de péri- 
phérique a installer. Cependant, vous pouvez utiliser la souris 
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comme maneite de jeu pour les logiciels plus anciens et garder 
’avantage donné par le mode proportionnel avec les nouvelles 
applications. 


La souris fonctionne en mode proportionnel par défaut. Pour 
obtenir le mode manette de jeu, brancher la souris dans l’un 
des deux ports manette de jeu sur le cote de lordinateur et 
maintenez le bouton droit enfoncé a la mise sous tension de 
lordinateur. 


Nettoyage de la souris 


Puisque la boule de votre souris doit rouler librement pour ma- 
nipuler de maniére précise le curseur (ou autre chose) a 
’écran, il est important que la boule soit tout a fait propre. On 
peut la retirer facilement en faisant glisser le cache de plasti- 
que qui tient la boule en place. 
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Retirez la boule et essuyez-la avec un chiffon doux. 


Pour nettoyer le logement de la souris, 
soufflez doucement dans louverture. 

Pour nettoyer les trois roulements 
mecaniques situés pres de l’ouverture, 
prenez un coton tige, humectez-le avec un 
liquide de nettoyage ou de l’alcool et 
frottez doucement la surface de 
chaque roulement. Replacez la 
boule dans son logement et remettez 
le cache plastique en place. 


Conseils pour Putilisation de la souris 


utilisation etl’entretien appropiés de votre souris exigent sur- 
tout du bon sens. 


Utilisez votre souris sur une surface propre et lisse. 


Assurez-vous d’avoir assez de place sur votre table pour 
manipuler la souris, pour éviter d’avoir a la soulever et a la re- 
positionner constamment. 


Ne tenez pas la souris par son cordon et ne la laissez pas pen- 
dre de la table. 
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Guide du développeur pour Ia souris 
proportionnelile 

Cette section explique la théorie de l’exploitation de la souris 
Commodore 1351 et suggére des stratégies logicielles pour 
l'interfacer. 


Introduction 

La souris Commodore 1351, utilisable avec la gamme de pro- 
duits C 64/C 128 est un petit périhérique avec deux boutons. 
Elle se connecte sur l’un des deux ports manette de jeu (joy- 
stick) du C 64/C 128. 

La souris supporte deux modes d’exploitation différents : 

1) le mode manette de jeu, 

2) le mode proportionnel. 

Le mode proportionnel sur le C 64 ou le C 128 utilise une inter- 
face spéciale en langage machine qui permet un rendement 
optimal du langage machine. 

On sélectionne le mode a la mise sous tension de lordinateur. 
Si l'utilisateur ne touche pas au bouton droit de la souris lors de 
la mise sous tension, la souris fonctionnera en mode propor- 
tionnel par défaut. 

Il est prevu en mode manette de jeu de fournir un mode opéra- 
toire dans lequel la souris peut étre utilisée comme une 
manette de jeu dans le cas ou le logiciel en cours d’exécution 
niaccepte pas le mode proportionnel. 


Mode manette de jeu 

En mode manette de jeu, la souris fonctionne comme suit : 

1) Sila souris est déplacée, les signaux appropriés de la ma- 
nette de jeu sont activés pour une période de 20 ms. Action- 
ner la souris revient a pousser la manette ae jeu dans la di- 
rection appropriée. 
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2) Le bouton gauche de la souris est adressé en tant que bou- 
ton de tir sur une manette de jeu. 

3) Le bouton droit de la souris est adressé dans le registre SID 
POTX (SID = Sound Interface Device, processeur sonore). 
Si le bouton est enfoncé, le registre SID POTX contiendra 
alors un nombre <$ 80. Si le bouton r’est pas enfoncé, le 
SID POTX contiendra alors un nombre >$ 80. 

4) Lisez la section “Avertissements sur les registres du SID“. 


Interface logiciel : 


Pour la plupart des applications, l’interface pour le mode opé- 
ratoire manette de jeu se comprotera comme un gestionnaire 
de manette de jeu et le bouton droit sera ignoré. 


Mode proportionnel 


En mode proportionnel, la souris agit comme suit : 

1) Le mouvement de la souris est transmis de maniére interne 
a la souris. La position de la souris MOD 64 est transmise 
aux registres SID POTX et POTY toutes les 512 us., ne 
demandant aucune intervention du logiciel. 


Le registre POTX est utilisé pour lire la position X (horizon- 
tale) et POTY pour lire la position Y (verticale) de la souris. 


Les contenus du registre sont les suivants : 


Position de loctet: |7|6|5/4/3]2!11| 0] 
Registre POT : |X |P5|P4/P3/P2/P1/Po| N 


Die cacencs est un bit transparent. 
P5-P0.. est la position de la souris MOD 64. 
 eeenrere est un bit (bruit) spécial (continue alire. . .). 


2) le bouton gauche de la souris est configuré comme le bou- 
ton de tir d’une manette de jeu. 
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3) Le bouton droit de la souris est configure comme la direction 
vers le haut (UP) sur une manette de jeu. 


Interface logiciel : 


1) Etant donné que les boutons de gauche et de droite appa- 

raissent comme des signaux de manette de jeu, les lire a 
partir d’un logiciel est un exercice facile en interrogation 
(polling). 
Notez qu’avec une manette de jeu, les boutons vont influen- 
cer le registre du port clavier et le logiciel doit faire un effort 
pour distinguer un point seul dans la matrice du clavier (une 
touche enfoncée) d’une colonne ou d’une rangée entiére a 
la masse (type de signal manette de jeu). 


2) Linformation de position nest pas difficile a obtenir. Cela 
correspond tout a fait a une routine d’interruption 50 hz (de 
préférence au début — voir la section sur Avertissements 
sur les registres du SID). 


La stratégie est la suivante : 
1) Lisez la position de la souris MOD 64. 


2) Déterminez si la souris a bougé en comparant la position 
courante avec la derniére position sauvegardee. 


3) Sila souris a bougé, modifiez alors la position de votre cur- 
seur de maniére appropriée. 


La souris fait un effort pour transférer une position vers le 
registre SID. Malheureusement, il yaun seul bit de bruit dansla 
transmission. 


Par exemple, méme si la souris est immobile, il est possible 
pour le registre POT d’osciller entre $ 80 et $ 7F. Ceci peut faire 
sauter la position de la souris d’un point a un autre. 


ll est cependant nécessaire de prendre en compte le bit de 
poids faible du registre POT avant de prendre une décision 
concernant un mouvement éventuel de la souris. 


22.0.0 séFrangaaiis 


Tout ceci peut étre vu dans le code du gestionnaire de la souris 
fourni. 


Avertissements sur les registres du SID: 


Dans le C 64 et le C 128, les registres du SID sont connectés 
aux deux ports manettes de jeux. Linterrupteur analogique 
A 4066 est utilisé pour changer les signaux POT entre les deux 
ports placés sur une des lignes de balayage du clavier. Les tra- 
vaux que le balayage normal interrompt de maniére temporai- 
re affectent les valeurs retournées dans les registres POT. 
Cependant, de maniére a exécuter des conversions fiables, 
les signaux POT doivent étre connectés a la souris pour une 
période > 1,6 ms avant que la valeur retournée dansle registre 
POT ne soit exacte. 


Le meilleur moyen pour cela est d’implanter le gestionnaire de 
la souris dans la routine IRQ, avant la partie consacrée au 
balayage du clavier. Ceci assure plus ou moins que les lignes 
de balayage de touches ont été suffisamment stabilisées 
avant que le registre POT ne soit lu par le gestionnaire de la 
souris. 
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English 


1351 Mouse 
User’s Guide 
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About this manual 


Basically, this manual is divided into two parts. The first part 
includes the introduction, mouse cleaning, and tips-for 
general care of the mouse. That part is for the user with 
mouse-compatible software, who wants simply to plug in 
the mouse and begin using it. The second part of the manu- 
al contains information needed by those who wish to deve- 
lop software for the mouse. 


26 English 


Introduction 


The Commodore 1351 Mouse” is a controller designed for use 
with the Commodore 64° or Commodore 128™ computers. It 
features two buttons on the top, and a ball on the underside 
that is rolled upon a flat surface to manipulate onscreen 
activity. 


The mouse has two modes of operation — joystick mode and 
proportional mode. 


In joystick mode, the mouse emulates a joystick and can be 
used with all joystick-compatible software. In this mode, the 
left button is the fire button and the right button is usually 
ignored. 


In proportional mode, the mouse uses a new technique to 
communicate mouse movement to the controlling application 
software. That requires the software to know the mouse is the- 
re and how to read it. For example, the GEOS™ operating 
system can use many different input drivers. One of them is the 
Commodore Mouse driver, which can be used with the 1351 in 
proportional mode. 


The 1351 provides a proportional mode so that applications 
can have a fast, responsive pointer that moves easily on the 
screen. Joystick mode acts as a fallback for those applications 
that don’t have installable device drivers. You can therefore 
use the mouse as a joystick for older software, and take advan- 
tage of the benefits provided by proportional mode with newer 
applications. 


The mouse automatically powers up in proportional mode. To 
choose joystick mode, plug the mouse into either joystick port 
on the side of the computer and hold down the right button as 
the computer is powered up. 
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MOUSE CLEANING 


Since the ball of your mouse mustroll freely to accurately mani- 
pulate the cursor (or whatever) on the screen, it’s important 
that the ball remains free of dirt or debris. This is easily accom- 
plished by sliding out the plastic piece holding the ball in place. 


Remove the ball and wipe it off with a soft cloth, such as a hand- 


kerchief. 
~~ 
dG 
gs 
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To remove any dirt or dust from the ball area, just blow gently 
into the opening. Around the top of the opening, there are 
three metal rollers. To clean these, take a cotton-tipped 
swab, moistened 
with head cleaning 
fluid or alcohol, and 
gently clean the 
surface of each 
roller. Replace the 
ball inside the 
controller and snap 
the plastic piece 
back on. 


MOUSE TIPS 

Proper care and use of your mouse requires common sense. 
Use your mouse on a clean, smooth surface. 

Make sure you have adequate desktop space to manipulate 
your mouse, so you don't have to constantly pick up and repo- 
sition it. 


Don't hold the mouse by its cord, or let the body of the mouse 
hang off the table. 
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PROPORTIONAL MOUSE 
DEVELOPER’S GUIDE 


This section explains the theory of operation of the Commo- 
dore 1351 mouse and suggests ways in which it can be interfa- 
ced to applications or software. 


INTRODUCTION 


The Commodore 1351 mouse for use with the C64/C128 pro- 
duct line is a small two-button device which is connected to 
either of the joystick ports on the C64/C128. 


The mouse supports two distinct operating modes: 
1) Joystick mode. 
2) Proportional mode. 


Proportional mode is usable with the C64 or the C128, and re- 
quires a special machine language driver to yield optimum 
performance. 


Mode selection is determined when the mouse is powered up. 
If the user depresses the right mouse button when the device is 
powered up, then the mouse will be in joystick mode. 


If the user does not depress the right mouse button when the 
device is powered up, then the mouse will default to proportio- 
nal mode. 


Joystick mode allows you to utilise the mouse as a joystick 
when using software which does not support proportional 
mode. 


JOYSTICK MODE 


In joystick mode the mouse operates as follows: 

1) If the mouse is moved, then the approriate joystick lines are 
activated for a period of 20 ms. Thus moving the mouse is 
like pushing the joystick in the appropriate direction. 
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2) The left mouse button is mapped to what would be the fire 
button on a joystick. 

3) The right mouse button is mapped into the SID POTX regi- 
ster. If the button is depressed then the SID POTX register 
will contain a number < $80. If the button is not depressed 
then SID POTX will contain a number >=$80. 

4) See the section on SID REGISTER CAUTIONS. 


Software interface: 


For most applications, the interface for joystick mode should 
be just as any joystick driver, and the right button should be 
ignored. 


PROPORTIONAL MODE 


In proportional mode the mouse operates as follows: 

1) Mouse movement is tracked internally within the mouse. 
The position of the mouse MOD 64 is transmitted to the SID 
POTX and POTY registers every 512 us and requires no soft- 
ware intervention. 

The POTX register is used to read the X position of the 
mouse and the POTY register is used to read the Y position 
of the mouse. 


The register contents are as follows: 


Bit Position '7/6/5/4/3/2/1 
POT Register Sc lpalpalPSlea Pon 


where: 
Me cuessveed is a don't care bit. 
P5-PO ... is the mouse position MOD 64. 
Mua ead es is a special (noise) bit (keep reading . . .). 


2) The left mouse button is mapped to what would be the fire 
button on a joystick. 
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3) The right mouse button is mapped to what would be the UP 
direction on a joystick 


Software Interface: 


1) Because the left and right buttons appear as joystick lines, 
reading them from software is a simple exercise in polling. 
Note that as with a joystick, the buttons will interfere with the 
keyboard map, and software should make some effort to 
distinguish between a point short in the keyboard matrix 
(i.e., a key being depressed), and a whole row or column 
being grounded (i.e., a joystick type of signal). 

2) The position information is not difficult to handle. Ideally is 
should be installed as part of the 60 Hz interrupt routine (pre- 
ferably at the beginning — see the section on SID REGI- 

_STER CAUTIONS). 
This strategy is as follows: 
1) Read the mouse position MOD 64. 
2)Determine if the mouse has moved by comparing the 
current position with a saved copy of the previous 
position. 
3) If the mouse has moved, then modify your pointer position 
appropriately. 

You should note, that even ifthe mouse is still, itis possible 
forthe POTregister to oscillate between $80 and $7F. 
This would result in the mouse position as jittering bet- 

ween two points. 


In order to asertain wether the mouse has moved the software 
should read the low order bit of the POT register. 


All of this can be seen in the supplied mouse driver code. 
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SID REGISTER CAUTIONS: 


in the C64 & C128, the SID pot lines are connected to both joy- 
stick ports. A 4066 analog switch is used to switch the POT 
lines between the two ports based on one of the keyboard scan 
lines. The means that the normal keyscan interrupt temporarily 
affects the values returned in the POT registers. Therefore, in 
order to perform reliable conversions, the POT lines must be 
connected to the mouse for a period > 1.6 ms before the value 
returned in the POT register is valid. 


The best way to insure this is to wedge the mouse driver soft- 
ware into the IRQ handler prior to the polled keyscan. This 
more-or-less assures that the keyscan lines have been suffi- 
ciently stable before the POT register is read by the mouse 
drivers. 
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Deutsch 


Mouse 
Manuale 
per utente 


Per computer 
Commodore C 64°, 
C 64 C", C 128" 


Italiano 
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Questo manuale contiente informazioni esclusive e protette 
da diritti d’autore. Nessuna delle sue parti puo essere riprodot- 
ta, registrata in un sistema informativo o trasmessa in alcuna 
formaoinalcun modo, meccanico, fotocopiato, registrato o al- 
tro, senza l’autorizzazione scritta della Commodore Electro- 
nics Limited. 


Mouse 1351 Commodore é un marchio di fabbrica della 
Commodore Electronics Limited. 


Commodore C 64 6 un marchio di fabrica della Commodore 
Electronics Limited. 


Commodore 128 é un marchio di fabbrica della Commodore 
Electronics Limited. 


Commodore e Commodore 64 sono marchi di fabbrica regi- 
strati della Commodore Electronics Limited. 


GEOS é un marchio di fabbrica della Berkeley Softworks. 


Copyright® 1986 Commodore Electronics Limited. 
Tutti i diritti riservati . 
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In linea di principico questo manuale é suddivisio in due parti. 
La prima parte comprende l’introduzione, la pulizia del mouse 
e consigli sull’uso e sulla manutenzione del mouse. Questa 
parte del mauale é rivolta a quegli utenti che sono in possesso 
di software funzionante con il mouse che possono quindi col- 
legarlo ed iniziare ad utilizzarlo. La seconda parte del manuale 
contiente informazioni per quegli utenti che vogliono sviluppa- 
re programmi espressamente per il mouse. 


Introduzione 


Il Mouse 1351™ della Commodore é un dispositivo di controllo 
studiato per il Commodore 64° o il Commodore 128”. Sulla 
parte superiore del mouse sono presenti due pulsanti e al di 
sotto diesso una sfera che, quando viene fatta scorrere suuna 
superficie piana, permette di gestire le attivita sullo schermo. 


ll mouse pud funzionare in due modalita: la modalita joystick 
oppure la modalita proporzionale. 


Nella prima modalita il mouse emula un joystick e pud essere 
utilazzato con tutti i programmi che permettono uso di questo 
disposivito. In questa modalita il pulsante sinistro é il pulsante 
fuoco, mentre il pulsante destro non viene generalmente 
utilizzato. 


Nella modalita proporzionale il mouse utilizza una nuova tecni- 
ca per comunicare i propri movimenti al software applicativo di 
controllo. Questo richiede che il programma sappia della pre- 
senza del mouse e sappia come interpretare i suoi movimenti. 
Ad esempio, i! sistema operativo GEOS™ puo utilizzare diversi 
driver di input, uno dei qauli é il driver del mouse Commodore, 
che pud essewre usato con il mouse 1351 in modalita propor- 
zionale. 


Grazie alla modalita proporzionale il mouse 1351 mette a dis- 
posizione dell’utente un puntatore veloce che si sposta agil- 
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mente sullo schermo. La modalita joystick invece pud essere 
un ripiego per quei programmi applicativi a cui non é possibile 
collegare un driver. ll mouse puo tuttavia essere utilizzato co- 
me joystick per i programmi meno recenti, mentre per i nuovi 
programmi applicativi puo essere sfruttata la modalita propor- 
zionale. 


AlPattivazione il mouse si trova in modalita proporzionale. Per 
attivare la modalita joystick occore collegare il mouse ad una 
delle porte per il joystick situate sul lato del computer e tenere 
premuto il pulsante destro mentre si accende il computer. 


Pulizia del mouse 


Per spostare in modo preciso il cursore sullo schermo é indis- 
pensabile che la sfera del mouse scorra liberamente e che i 
suo movimento non venga impedito da polvere o particelle 
estranee. Per la pulizia della sfera é sufficiente fare scorrere la 
parte in plastica che blocca la sfera. 
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Estrarre le sfera e pulirla con un panno morbido, ad esempio 


un fazzoletto. 
Pe ata 
YE 
\ ae 


Per eliminare polvere o particielle estranee 
dall’alloggiamento della sfera é sufficiente 
soffiare piano nell’apertura. Nalla parte 
superiore di quest’ultima sono presenti tre 
piccoli cilindri in metallo. Per pulire questi 
cilindri passare delicatamente sulla loro 
superficie un bastoncino cotonato, 
inumidito con liquido per la pulizia delle 
testine oppure con alcol. Reintrodurre 

la sfera nel mouse e risposizionare la 
parte in plastica che la blocca. 


Consigli 
Fare scorrere il mouse su una superficie pulita e piana. 


Assicurarsi che vi sia sufficiente spazio di movimento per il 
mouse, in modo da non deoverlo continuamente sollevare e 
riappoggiare sul piano. 


Non tenere il mouse per il cavo e non farlo penzolare dal tavolo. 


Guida alla modalita’proporzionale 
(per programmatori) 


Questa sezione del manuale spiega in teoria il funzionamento 
del mouse 1351 della Commodore e suggerisce alcuni metodi 
per interfacciarsi a questo mouse. 
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Introduzione 


ll mouse 1351 Commodore per I’uso con la linea di prodotti 
C 64/C 128 é un piccolo dispositivo a due pulsanti che viene 
collegato ad una delle porte per il joystick dei computer C 64/ 
C 128. 


ll mouse supporta due modalita operative distinte: 

1) la modalita joystick 

2) la modalita proporzionale. 

La modalita proporzionale viene utilizzata con il C 64 0 ilC 128 
ed impiega uno speciale driver in linguaggio macchina per ot- 
tenere il massimo dalle prestazioni del computer. 


La selezione della modalita viene determinata all’accensione 
del mouse. Se l’utente preme il pulsante destro del mouse 
mentre accende il computer, attivera la modalita joystick. 


Se l’utente non preme i! pulsante destro del mouse all’accen- 
sione del computer, verra attivata per default la modalita pro- 
porzionale. 


La modalita joystick permette di utilizzare, il mouse come se 
fosse un joystick nei casi in cui il software impiegato non sup- 
porti la modalita proporzionale. 


Modalita joystick 
Nella modalita joystick il mouse funziona nel modo seguente: 


1) Se il mouse viene spostato, le linee di joystick appropriate 
vengono attivate per un periodo di 20 ms. Quindi lo sposta- 
mento del mouse equivale allo spostamento del joystick 
nella direzione appropriata. 

2) il pulsante sinistro del mouse funziona come il pulsante fuo- 
co su un joystick. 
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3) ll pulsante destro del mouse é mappato nel registro POTX 
SID. Se il pulsante viene premuto, il registro POTX SID con- 
terraun numero < $80. Se il pulsante non viene premuro, i! 
registro POTX SID conterra un numero > = §$ 80. 

4) Vedere la parte del manuale relativa al REGISTRO SID. 


Interface software: 


Per la maggior parte dei programmi applicativi l’interfaccia per 
la modalita joystick dovra corrispondere ad un qualsiasi driver 
per joystick ed il pulsante destro del mouse verra ignorato. 


Modalita proporzionale 

Neila modalita proporzionale il mouse funziona come spiegato 

di seguito: 

1) Lo spostamento del mouse viene tracciato al suo interno. La 
posizione die MOD 64 del mouse viene trasmessa ogni 512 
us. ai registri POTX e POTY SID, senza alcun intervento 
software. 

\l registro POTX viene utilizzato per la lettura della posizione 
X del mouse ed il registro POTY viene utilizzato per lalettura 
della posizione Y del mouse. 


Il contenuto del regitro é il seguente: 


Posizione bit: [7/6[5]4]/3]/2/1]0 
Registro POT: X [P5|P4/P3|P2|P1|PO| N | 


dove: 
De aceanuewununnens é un bit ininfluente 
P'S-P Oh cscs é la posizione MOD 64 del mouse 
SN ctiedetateten: é un bit speciale (disturbo) 


2) Il pulsante sinistro del mouse é mappato in modo de agire 
come il pulsante fuoco su un joystick. 
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3) ll pulsante destro del mouse é mappato in modo da provoca- 
re lo spostamento verso l’alto come su un joystick. 


Interface software: 


1) pulsanti sinistro e destro del mouse appaiono come linee di 

joystick. Per questo motivo la loro lettura dal software é mol- 
to semplice in polling. 
Notare che, come avviene con un joystick, i pulsanti interfe- 
riscono con la mappatura della tastiera ed i! programma 
deve fare uno sforzo notevole per distinguere tra un punto 
nella matrice di tastiera (cioé un tasto premuto) e uno intera 
riga o colonna (cioé un tipo di segnale di joystick). 

2) | dati di posizione sono semplici da gestire in quanto si tro- 
vano idealmente nella routine di interrupt da 60 Hz (prferibil- 
mente all’inizio — vedere la sezione relativa al REGISTRO 
SID). 


La procedura é la seguente: 
1) Leggere la posizione MOD 64 del mouse. 


2) determinare se il mouse é stato spostato confrontando la 
posizione corrente con una copia memorizzata della posi- 
zione precedente. 


3) Se il mouse é stato spostato, modificare di conseguenza la 
posizione del puntatore. 


ll mouse effettua con diffcolta la trasmissione di una posi- 
zione al registro SID. Purtroppo, nella trasmissione viene 
emesso un singolo bit di disturbo. 


Ad esempio, anche se il mouse fosse fermo, il registro POT 
potrebbe vacillare tra $ 80 e $70. Questo provoca l’ondeg- 
giamento tra due punti della posizione del mouse. 
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E’tuttavia necessario considerare il bit meno significativo del 
registro POT prima di decidere se il mouse sia stato o meno 
spostato 


Quanto sopra puo essere verificato dal codice del driver del 
mouse fornito. 


Registro SID: 


Nei computer C 64 eC 128 le linee POT del SID vengono colle- 
gate a entrambe le porte del joystick. Per commutare le linee 
POT dauna porta all’altra viene utilizzato un interruttore analo- 
gico 4066 basato sa una delle linee di scansione della tastiera. 
Linterrupt della scansione normale dei tasti influenza tempo- 
raneamente i valori ritornati nei registri POT. Quindi, per ese- 
guire delle conversioni attendibili, le inee POT devono essere 
collegate al mouse per un periodo maggiore di 1,6 ms prima 
che il valore ritornado nel registro POT sia valido. 


Il miglior modo per ottenere quanto sopra sarebbe quello di in- 
serire il software del driver del mouse nel gestore IRQ prima 
della scansione a polling. Questo assicura pi uo meno che le li- 
nee di scansione siano sufficientemente salde prima della let- 
tura del registro POT da parte dei driver del mouse. 
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Deutsch 


Raton 1351 
Guia del 
usuario 


Para utilizarlo con los 
ordenadores Commodore: 
C 64, C 64 C, C 128 
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La informacion contenida en este manual ha sido revisada y 
considerada como completamente veraz. Sin embargo no se . 
asume ninguna responsabilidad debida a posibles inexactitu- 
des del texto, de los programas descritos, o del resto de las in- 
strucciones, asi como de los resultados de su aplicacién con 
cualquier proposito. 

Ninguna parte de esta publicacién puede ser reproducida, 
grabada ni transmitida de forma alguna y no importa por qué 
medio, electronico, mecanico, de fotocopia u otro tipo, sin pre- 
vio consentimiento por escrito de Commodore International. 


importante 


Este equipo ha pasado los controles de calidad impuestos por 
el gobierno de los EE UU para un dispositivo de ordenador Cla- 
se B, de acuerdo con las especificaciones de la Subseccion J 
de le Seccién 15 de las normas FCC (Federal Communications 
Commission), que han sido creadas para proporcionar, enuna 
instalacion residencial, una proteccion razonable frente a las 
interferencias. 


Sin embargo, el equipo puede originar interferencias en la re- 
cepcion de sus aparatos de radio y television, si no lo instala y 
utiliza siguiendo, de una forma estricta, las instrucciones del 
fabricante. 


Por ejemplo solo deben conectarse al ordenador periféricos 
que dispongan de cables blindados con toma de tierra, que 
cumplan con las normas de Clase B. Los demas periféricos 
generaran interferencias en la recepcion. 


En el caso de que se produzca algun tipo de interferencia en 
una instalaci6n particular, el usuario puede intentar corregirla 
siguiendo una 0 varias de las siguientes medidas: 


¢ Orientar de nuevo la antena de recepcion. 
e Situar el monitor lejos del receptor. 
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e Conectar el equipo en una toma de alimentacion distinta, de 
forma que el receptor se encuentre en otro circuito de la ins- 
talacion. 

En el caso de que fuese necesario, el usario consultara con su 

proveedor o con un técnico experimentado de radio-televi- 

sién. 

Commodore 1351 Mouse 

es una marca registrada de Commodore Electronics Limited. 


Commodore 64 C 
es una marca registrada de Commodore Electronics Limited. 


Commodore 128 
es una marca registrada de Commodore Electronics Limited. 


Commodore y Commodore 64 
son marcas registradas de Commodore Electronics Limited. 


GEOS es una marca registrada de Berkley Softworks. 


Copyright 1986 por Commodore Electronics Limited. 
Todos los derechos reservados. 
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Sobre este manual 


Basicamente este manual se divide en dos partes. La primera 
incluye la introducci6n y el cuidado del rat6n. Esta parte esta 
enfocada al usuario con un software compatible con el raton y 
que desea conectar éste y empezar a utilizarlo. La segunda 
parte contiene informacién necesaria para aquéllos que de- 
sean desarrollar software para el raton. 


Introduccion 


El raton 1351 de Commodore es un controlador creado para 
su utilizacién con los ordenadores Commodore 64° y 
Commodore 128™. Tiene dos botones en la parte superior y 
una bola en la inferior, que al rodarla sobre una superficie pla- 
na permite manipular la actividad en la pantalla. 


El raton tiene dos formas de funcionamiento: el modo joystick 
y el modo proporcional. En el modo joystick emula a un joystick 
y puede utilizarse con todo el software compatible con el mis- 
mo. Eneste modo el botdn izquierdo es el de disparo y el dere- 
cho suele dejarse sin utilizar. En el modo proporcional, el raton 
utiliza una nueva técnica para comunicar el movimiento al 
control del software de aplicacion. Para ello es necesario que 
el software sepa que el raton se encuentra presente y como 
leerlo. Por ejemplo, el sistema operativo GEOS”™ puede utilizar 
diferentes drivers de entrada. Uno de ellos es el driver del raton 
Commodore, que puede utilizarse con el 1351 en modo pro- 
porcional. 


El modo proporcional del 1351 permite que las aplicaciones 
puedan tener un puntero de rapida respuesta, que se mueva 
con facilidad enla pantalla. El modo joystick actua como un re- 
curso de emergencia para aquellas aplicaciones que no tie- 
nen drivers para el raton. De esa forma pueda utilizar el raton 
como un joystick en el software antiguo, beneficiandose de las 
ventajas del modo proporcional con nuevas aplicaciones. 
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E! raton funciona por defecto en modo proporcional. Para 
cambiar a modo joystick, conecte el raton en cualquiera de los 
ports de joystick en el lateral del ordenador y mantenga pulsa- 
do el boton derecho mientras conecta el ordenator. 


Limpieza del ratén 


Para utilizar el raton con toda exactitud, necesita poderlo des- 
plazar sin obstaculos que lo frenen, para ello la bola debe en- 
contrarse libre de suciedad. Para limpiarla deslice la placa que 
la mantiene en su sitio 


saque la bola y frotela con una tela suave, como un pafiuelo. 
fen 
OK \, 
| vi 
\ > 
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Para extraer la suciedad, que pueda 
permanecer en el area de giro, sople 
con cuidado. Alrededor de la abertura 
hay tres rodillos metalicos, limpielos 
pasando suavemente un trapo de 
algod6n humedecido en alcohol, por 
cada uno de ellos. 


Site de nuevo la bola en su sitio y vuelva a colocar la placa de 
sujeccion. 


Indicaciones de uso 

El uso adecuado de su raton solo requiere un poco de sentido 
comun: 

Utilicelo sobre una superficie limpia y lisa. 


Asegurese de que tiene bastante espacio sobre la mesa para 
moverlo, de forma que no tenga que estar levantandolo conti- 
nuamente. 


No lo sujete por el cordén nilo deje colgando fuera de la mesa. 
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Guia de desarrollo 


Esta seccion explica la teoria de operacion del raton 1351 y su- 
giere técnicas de software para acoplarse con este periférico. 


Introduccién 


El raton 1351 que se utiliza con los Commodore C 64 y C 128, 
es un dispositivo de bos botones que se conecta a cualquiera 
de los ports de joystick del C 64 o del C 128. Tiene dos formas 
de funcionamiento: modo joystick y modo proporcional. Este 
ultimo es el modo por defecto. Para pasar al modo joystick 
basta con tener pulsado el botén derecho en el momento de 
activar el raton. El modo joystick permite utilizar un software 
que no soporte el modo proporcional. El modo proporcional 
utiliza un driver especial que produce un resultado 6ptimo con 
el lenguaje maquina. 


Modo Joystick 
En este modo el ratén opera de la forma siguiente: 


1) Sise mueve el raton las lineas de joystick correspondientes 
se activan por un periodo de 20 ms. De esa forma mover el 
raton es como empujar el joystick en la direccion adecuada. 


2) El botén izquierdo del rat6n correspondiente a lo que seria 
el boton de disparo del joystick. 


3) El boton derecho del raton se encuentra acoplado en el re- 
gistro SID POTX. Si se pulsa el botdn, el registro SID POTX 
contendra un numero <$ 80. Si no se pulsa el botén, SID 
POTX contendra un numero> = $ 80. 


4) Vea el apartado PRECAUCIONES CON EL REGISTRO 
SID. 
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INTERFACE DE SOFTWARE 


Para la mayor parte de las aplicaciones el interface para el mo- 
do de operacidn joystick, sera como para cualquier driver de 
joystick, y no se tendra en cuenta el boton derecho. 


MODO PROPORCIONAL 
En el modo proporcional el raton opera de la forma siguiente: 


1) El movimiento es registrado internamente por el raton. Su 
posicién MOD 64 es transmitida al SID POTX y POTY, regis- 
strado cada 512 us, sin intervenci6n de software. El registro 
POTX se utiliza para leer la posicion X del ratén y el registro 
POTY para leer la posicién Y. 


EI contenido del registro es el siguiente: 


Posicién de bit [7/6/[5/4][3 0 
RegistroPOT | X |P5|P4/P3}P2/P1|P0| N 


donde: 
Me ceesac tue sentals es un bit no utilizado 
P5-PO sccsaiis es la posicién MOD 64 del ratén 
IN cata biets soon es un bit especial de interferencia 


2) El boton izquierdo del rat6n corresponde a lo que seria el 
boton de disparo de un joystick. 


3) El botén derecho a lo que seria la direccidn ARRIBA en un 
joystick. 


Interface de software 


1) Ya que los botones derecho e izquierdo aparecen como 
lineas de joystick, su lectura del software es un simple ejer- 
cicio de sondeo. 


Note que, como en el caso del joystick, los botones se 
mezclan con el mapa de teclado, y el software debera es- 
forzarse para distinguir entre un punto en la matriz del tecla- 
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do (una tecla pulsada), y toda una fila o columna (el tipo 
de senal del joystick). 


2) Lainformaci6n de posicién no es dificil de manejar. Se si- 
tua, en general, enlarutina de interrupcién de 60 hz (pre- 
feriblemente al comienzo, vea el apartado PRECAUCIO- 
NES CON EL REGISTRO SID). 


La estrategia es la siguiente: 
a) Lea la posicion MOD 64 del raton. 


b) Determine si el raton se ha movido comparando la po- 
sicion actual con una copia grabada de la posicién 
previa. 


c) Sielraton se ha movido modifique, de una forma apro- 
ximada, la posicién del puntero. 
Al transmitir una posicion al registro SID, el raton se 
encuentra con la dificultad de la existencia de un unico 
bit de interferencia en la transmisién. Esto significa 
que, aunque el raton se encuentre quieto, es posible 
que el registro POT vacile entre $ 80 y $ 7F, como si 
estuviese oscilando entre dos puntos. 


Esnecesario por lo tanto tener en cuenta el bit de orden inferior 
del registro POT, antes de tomar ninguna decision en cuanto a 
si el raton se ha movido. 


Todo esto puede verlo en el cdédigo de! driver del raton. 


Precauciones con el Registro SID 


EnelC 64yC 128, las lineas SID POT se encuentran conecta- 
das a ambos ports de joystick. Un interruptor analdgico 4066, 
se utiliza para conmutar las lineas POT con los dos ports, ba- 
sados en una de las lineas scan del teclado. Esto significa que 
lainterrupcion normal de la exploracion de teclado afecta tem- 
poralmente los valores devueltos a los registros POT. Por lo 
tanto, para poder realizar conversiones seguras, las lineas 


Espajiol Fai eS 3 BS 


POT deben estar conectadas al rat6n durante un periodo 
=> 1.6 ms antes de que el valor devuelto al registro POT sea 
valido. 

La mejor forma de asegurar ésto consiste en insertar el soft- 
ware del raton enel IRQ, antes del sondeo de la exploracion de 
teclado. Esto asegura, en cierto modo, que las lineas de explo- 
racion de teclado hayan conseguido una cierta estabilidad, 
antes de que el registro POT sea leido por los drivers del raton. 
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1351 Muis 
Gebruiks- 
handleiding 


Voor de C G64, C 64 C, 
C 128 Computers 


Nederlands 
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Het copyright van deze gebruikshandleiding berust bij 
Commodore B.V. 

Deze handleiding bevat informatie waarop de het ateursrecht 
vantoepassing is. Geen enkel deel van dit werk mag op enige 
wijze worden gereproduceerd, overgenomen, in een bestand 
opgenomen, of overgedragen worden zonder voorafgaande 
schriftelijke toestemming van Commodore Nederland. 


Eerste druk, september 1986 
Copyright © 1986 Commodore Nederland B.V. 
Alle rechten voorbehouden. 
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Opgelet: 


Deze apparatuur genereert en gebruikt HF radio straling. In- 
dien de aansluitvoorschriften niet goed in acht worden geno- 
men, kan storing ontstaan in de ontvangst van radio- en TV- 
signalen. De apparatuur is echter in overeenstemming met de 
eisen van de P.T.T., welke opgesteld zijn om deze storingen te 
beperken. Indien u toch een vorm van storing ondervindt, kunt 
u testen of de muis de storingbron is door de computer met en 
zonder muis aan en te schakelen. Als de muis de storing ver- 
oorzaakt, voer dan de volgende handelingenuit: 


¢ draai de ontvangstantenne van TV of radio ontvanger in een 
andere richting. 

© zet de computer verder van de ontvanger af. 

e verplaats de computer. 

@ sluit de computer en de ontvangen ieder op verschillende 
stopcontacten aan. 

e Is de ontvangstapparatuur op een juiste wijze aan de CAI of 
kabel aangesloten, en maakt u gebruikt van coaxiale ka- 
bels? 


Raadpleeg zonodig uw leverancier of een radio/tv technicus 
voor advies. 


Voorwoord. 


Deze handleiding bestaat uit twee delen. Het eerste deel be- 
staat uit de introductie, het reinigen en gebruiken van de muis. 
Dit gedeelte is bedoeld voor gebruikers welke de muis simpel- 
weg willen aansluiten en met behulp van gekochte software 
met de muis werken. Het tweede gedeelte bevat informatie no- 
dig om zelf software te schrijven welke het gebruik van de muis 
ondersteunt. 
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Introductie. 


De Commodore 1351 muis is een besturingsapparaat speciaal 
voor de C 64 en C 128 computers ontworpen. De muis heeft 
twee knoppen aan de bovenkant, en een bal aan de onderzijde 
welke door de muis over een viakke ondergrond te bewegen 
rolt en hierdoor de cursor over uw beelscherm stuurt. 


De muis heeft twee werkstanden: ¢ De joystick stand. 
e Een proportionele stand. 


In de Joystick stand zal de muis een joystick imiteren, en kan 
dus met alle joystick bestuurbare software gebruikt worden. In 
deze stand, zal de linkermuistoets als de vuurknop reageren 
en de rechtermuistoets geen funktie hebben. 


In de proportionele stand, maakt de muis gebruik van een 
nieuwe techniek van doorgeven van muisbewegingen aan de 
applicatie software. Deze stand van werken heeft software 
nodig welke weet dat de muis aanwezig is, en hoe de muis be- 
wegingen geinterpreteerd moeten worden. 


Het voordeel van een proportionele stand is dat reactie tijd van 
de applicatie software op muis bewegingen beduidend sneller 
zal zijn. Om de muis een zo breed mogelijk toepassings gebied 
te geven heeft hij een joystick stand voor oudere joystick be- 
stuurde programma’s en een proportionele stand voor nieu- 
were applicaties. 


De muis start automatisch op in de proportionele stand. U kiest 
de joystick stand door tijdens het aanzetten van de computer 
de rechtermuistoets ingedrukt te houden. 
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Reinigen van de Muis 


Om Zo accuraat mogelijk op de bewegingen van uw muis te 
reageren is het essentieel dat de bal met zo min mogelijk 
wrijwing kan rollen. Om deze reden is het noodzakelijk dat de 
bal zo schoon mogelijk is. U kunt de bal uit uw muis halen door 
het plastic plaatje onder aan de muis met uw beide duimen in 
de richting van de pijlen te duwen. U kunt nu het plaatje en de 
bal verwijderen. 


Reinig de bal nu met een zachte doek, bijvoorbeeld een zak- 
doek. 


st, 
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Stof in de bal opening kunt u verwijderen 
door in deze opening te blazen. In de 
bal opening bevinden zich drie metalen 
rollers. U kunt mogelijke vervuiling 

van deze rollers verwijderen met een 
wattenstokje gedoopt in alcohol. 

Als u de bal en rollers gereinigd heeft 
plaatst u de bal terug in de muis en 
schuift u het plastic plaatje weer op 
zijn plaats door deze in tegenover 
gestelde richting van de pijl 

te duwen. 


Enkele tips. 


© Door de muis op een schoon vlak oppervlak te gebruiken zal 
de muis langer zonder onderhoud goed biijven funktioneren. 

© Zorg dat u genoeg ruimte heeft om uw muis te bewegen zo- 
dat u niet steeds de muis hoeft op te tillen en te verplaatsen 
om een beweging af te maken. 

® Til de muis niet op aan zijn snoer, en laat ook de muis niet aan 
zijn snoer aan de computer bungelen. 


Proportionele muis aansturing handleiding. 


In dit hoofstuk zal de werking van de Commodore 1351 muis 
uitgelegd worden, en zullen enkele voorbeeld programma’s 
staan om als programmeur van de proporionele stand van uw 
muis gebruik te maken. 


Introduktie. 


De Commodore 1351 muis is een klein met twee toetsen voor- 
zien apparaat welke u op een van de twee joystick poorten van 
uw C 64 of C 128 aan kunt sluiten. 
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De muis heeft twee werkstanden: 
— De joystick stand. 
— Een proportionele stand. 


De proportionele werkstand kan met een C 64 of C 128 gebruikt 
worden, en maakt gebruik van een speciaail machinetaal 
besturingsprogramma, waardoor optimale snelheid met 
programma’s verkregen kan worden. 


Het selecteren van een werkstand gebeurd bij het opstarten 
van de computer. Als de gebruiker de rechter muistoets bij het 
opstarten ingedrukt houdt zal de muis in de joystick stand 
schakelen. 


Als deze toets bij het opstarten niet ingedrukt wordt zal de muis 
in de standaard proportionele stand schakelen. 


De intentie van de joystick stand is een werkstand te bieden 
waar de muis als een joystick gebruikt kan worden, in de geval- 
len dat de software de proportionele stand van de muis niet on- 
dersteunt. 


De joystick werkstand. 
In de joystick werkstand werkt de muis als volgt: 


1) Als de muis wordt verplaatst, zullen de daar voor bestemde 
signaallijnen voor een periode van 20 ms. geactiveerd wor- 
den. Dus m.a.w. het verplaatsen van de muis in een bepaal- 
de richting heeft het zelfde effect als het omen: van de joy- 
stick handle in de zelfde richting. 

2) De linker muistoets héeft de zelfde werking als de vuurtoets 
van de joystick. 

3) De rechter muistoets wordt in het SID POTX register gezet. 
Als de toets ingedrukt wordt zal in dit register de waarde <$ 
80 staan. Als hij nietingedruktis zal in het register de waarde 
>>= $ 80 staan. 
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4) Zie verder punt 1 van het onderdeel »Proportionel stand“. 


Software interface. 


Voor de meeste applicaties, zal de interface voor de joystick 
stand conform een normaal joystick aansturingsprogramma 
werken, en de rechtertoets geen funktie hebben. 


Proportionele stand. 
In de proportionele stand werkt de muis als volgt: 


1) Muis bewegingen worden intern in de muis geregistreerd. 
De positie van de muis MOD 64 wordt zonder enige software 
interventie iedere 512 micro seconde naar de SID registers 
POTX en POTY gezonden. Het POTX register wordt ge- 
bruikt om de X positie van de muis te bepalen en het POTY 
register voor de Y positie. 


De POT registers kunnen de volgende waarden bevatten: 


Bit positie 
POT Register 


2) De linker muistoets heeft de zelfde werking als de vuurknop 
van een joystick. 

3) De rechter muistoets werkt gelijk aan het naar voren duwen 
van uw joystick handle. 


Software interface 


1) Omdat de linker en rechter muistoets als joystick signalen 
werken is het uitlezen van deze toetsen een oefening her- 
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haald afvragen van deze toetsen. Let op! Net zoals het met 
een joystick het geval is, zullen de muistoetsen de werking 
van het toetsenbord beinvioeden, en software zal dus on- 
derscheid moeten maken tussen het indrukken van een 
toetsenbordtoets en een muistoets. 


3) De positie informatie zal niet moeilijk te verwerken zijn. Deze 
past precies tussen de 50 HZ interrupt routine (bij voorkeur 
aan het begin — zie hiervoor punt 1 van het onderdeel ,,Pro- 
portionele stand“). 


Het uitlezen gaat als volgt: 

1) Lees de muispositie MOD 64 

2) Ga na of de muis beweegt door de huidige positie te verge- 
lijken met een door u opgeslagen vorige positie. 

3) Als de muis is bewogen, verander dan overeenkomstig de 
cursorpositie. 
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1351 PIN LAY-OUT. 


AANSLUIT TABEL 
FUNKTIE 


FPINNO. | JOYSTICK STAND | PROPORTIONEELE STAND _ 
[~e [Neen NET GEBRUKT | 
[ve [uns Sd NET GEBRUKT 

| 

CUNKER TOES 
oe 
aed 


LINKER TOETS 
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1351 MUS 
Brugervejledning 


Anvendes sammen med 
Commodore computerne 
C 64, C 64 C, C 128 
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Advarsel: 


Dette udstyr er fundet i overensstemmelse med graenserne for 
en Klasse B computer-enhed, ifalge Underafsnit J af Kapitel 15 
af Federal Communications Commisionens regler, som er la- 
vet for at give rimelig beskyttelse mod radio- og fjernsynsfor- 
styrrelser i en beboelses installation. Hvis udstyret ikke instal- 
leres korrekt, i streng overensstemmelse med fabrikkens in- 
struktioner, kan udstyret forarsage sadanne forstyrrelser. Hvis 
De har mistanke om forstyrrelser, kan De teste udstyret ved at 
taende og slukke for det. Hvis udstyret forarsager forstyrrelse, 
rettes dette ved hjzelp af folgende fremgangsmader: 


e Justering af modtageantennen 

e Prav af placere computeranlzeg og modtager i et andet ind- 
byrdes forhold 

e Slut computeranleegger til en anden stikkontakt, sa mod- 
tager og computeranleeg benytter forskellige kredslob 


Om nedvendigt kontaktes Deres Commodore forhandiler eller 
en erfaren radio/TV-tekniker for yderligere spergsmal. 


Ferste udgave, september 1986 
Copyright® Commodore Electronics Limited 
Alle rettigheder forbeholdt. 


Denne vejledning indeholder oplysninger, som er forsynet 
med copyright og ejendomsret. Ingen del af denne tryksag ma 
reproduceres, lagres i et genfindings-system, eller transmitte- 
res pa nogen made eller via nogen midler, elektronisk, mekan- 
isk, fotokopiering, optegnelse eller andet, uden forudgaende 
skriftlig tilladelse fra Commodore Electronics Limited. 


Commodore 1351 Mus er et varemzerke, som tilhgrer Commo- 
dore Electronics Limited. 
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Commodore 64 C er et varemezerke, som tilhorer Commodore 
Electronics Limited. 


Commodore 128 er et varemzerke, som tilhorer Commodore 
Electronics Limited. 


Commodore og Commodore 64 er registrerede varemeerker, 
som tilhorer Commodore Electronics Limited. 


GEOS er et varemzerke, som tilhgrer Berkeley Softworke. 


Copyright® 1986 Commodore Electronics Limited 
Alle rettigheder forbeholat 
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Om denne vejiedning 


Denne vejledning er inddelt i to dele. Forste del omfatter 
vejledning i renggring af musen, og tip vedrarende almindelig 
vedligeholdelse af musen. Denne del er beregnet for den bru- 
ger, der har muse-kompatibel software, og som blot gnsker at 
tilslutte musen og begynde at bruge den. Anden del af vejled- 
ningen indeholder oplysninger, som er nodvendige for perso- 
ner, som @nsker at udvikle software til musen. 


Introduktion 


Commodore 1351 Mus™ er en kontroller, designet til brug med 
computerne Commodore 64® eller Commodore 128™. Den er 
forsynet med to knapper ovenpa, og har pa undersiden en 
kugle, som rulles pa en flad overflade for handtering af 
skeermaktivitet. 


Musen kan arbejde i to modes — joystik-mode og proportio- 
nal-mode. 


_ Ijoystik-mode svarer musen til et joystik og kan bruges med al 
joystik-kompatibe! software. | dette mode er venstre knap affy- 
ringsknap, og hajre knap bruges normalt ikke. 


| proportional-mode bruger musen en ny teknik til at videregive 
musebeveegelse til den styrende applikations-software. Deter 
saledes nedvendigt, at softwaren ved, at musen er der, og 
hvordan det kommunikerede skal laeses. F.eks. kan GEOS™ 
operativsystemet bruge mange forskellige input kilder. En af 
dem er Commodore Mus driveren, som 1351 i proportional mo- 
de. 


1351 giver proportional mode pa en sadan made, at applikatio- 
nar kan veere forsynet med en hurtig, velreagerende markar, 
som let beveeger sig pa skzermen. Joystik-mode fungerer som 
alternativ for de applikationer, som ikke har installerbare appa- 
rat-drivere. De kan derfor bruge musen som joystik sammen 
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med zeldre software og drage fordele af musens fordele i pro- 
portional mode sammen med nyere applikationer. 


Musen starter automatisk op i proportional mode. For at veelge 
joystik-mode tilsluttes musen via en af joydstikportene pa si- 
den af computeren og hajre knap holdes nede, samtidig med 
at der taendes for computeren. 


Rengoring af musen 


Da musens kugle skal kunne rulle frit for at beveege cursoren 
(eller andet) preecist pa skeermen, er det vigtigt at kuglen er fri 
for snavs og lignende. Renggring udfgres nemt ved at skubbe 
det plastikstykke ud, som holder kuglen pa plads. 


Fjern kuglen og ter den af med en biad klud, f.eks. et lommeter- 
klaeede. 
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Pust let ind i hullet, hvor kuglen normalt 
sidder, for at fierne snavs og stav. Omkring 
abningens top er der tre metalruller. Tag 
en vatpind, fugtet med renseveeske eller 
sprit, og rens forsigtigt overfladen pa hver 
rulle. Placer igen kuglen i musen og szet 
plastikstykket pa plads. . 


Muse-tips 


Brug den sunde fornuft ved behandling og anvendelse af 
musen. 


Brug musen pa en ren, glat overflade. 


Sorg for at have tilstreekkelig plads til at bevaege musen pa, sa 
det ikke er nedvendigt at lofte den og atter seette den ned for 
fortsat at bruge den. 


Hold ikke musen iledningen, og lad ikke musen heenge ud over 
bordet. 


Poportional mus vejledning for udviklere 


Dette afsnit forklarer teorien for anvendelse af Commodore 
1351 mus og foreslar software strategier for brug af interface til 
musen. 


Introduktion 


Commodore 1351 musen til brug sammen med C 64/C 128 
produkterne er en lille enned med to knapper, som forbindes 
med en af joystik-portene pa C 64/C 128. 


Musen supporter to szerskilte drift-modes: 


1) Joystik-mode. 
2) Proportional-mode. 
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Proportional-mode kan bruges sammen med C 64 eller C 128 
og bruger en speciel maskin-kode driver, hvilket giver optimal 
udfgrelse af maskin-kode. 


Valg af mode bestemmes, nar der taendes for musen. Hvis 
brugeren trykker hgjre knap. pa musen ned, nar enheden teen- 
des, starter musen i joystik-mode. 


Hvis hgjre knap pa musen ikke trykkes ned, nar enheden taen- 
des, starter musen i proportional mode. 


Meningen med joystik-mode er at give en funktions-mode, 
hvor musen kan bruges som joystik i tilfaelde, hvor den softwa- 
re, der anvendes,ikke understetter proportional mode. 


Joystik-mode 
| joystik-mode virker musen som falger: 


1) Hvis musen bevaeges, aktiveres de tilsvarende joystiklinier i 
en periode pa 20 ms. D.v.s. at bevaegelse af musen svarer til 
at skubbe joystikket i den tilsvarende retning. 

2) Den venstre knap pa musen svarer til det, der ville vaere affy- 
ringsknappen pa et joystik. 


3) Den hajre knap pa musen har forbindelse til SID POTX regi- 
stret. Hvis knappen trykkes ned, vil SID POTX registret inde- 
holde et tal < $ 80. Hvis knappen ikke trykkes ned, vil SID- 
POTX indeholde et tal > $ 80. 


4) Se afsnittet om SID REGISTER FORHOLDSREGLER. 


Software interface: 


For de fleste applikationer gzelder, at interface for brug af joy- 
stik mode skal vere lige som en joystik-driver, og den hajre 
knap skal undlades. 
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Proportional mode 
| proportional mode virker musen som falger: 


1) Muse-beveegelse spores internt til musen. Positionen af 
musens MOS 64 transmitteres til SID POTX og POTY regi- 
strene hver 512 us. (microsekund), uden software-inblan- 
ding. POTX-registreret bruges til at jase musens X-posi- 
tion, og POTY-registret bruges til at jase musens Y-posi- 
tion. 


Indholdet af registret er som falger: 


Bit position 7|6/5/4/3};2;1/0 

POT register _| X |P5|P4/P3/P2/P1|PO| N 

hvor: 
Mi cgntrnetwaes er en bit som skal overses. 
P5-P0...... er musens position MOD 64 
Saenger eee er en speciel (staj) bit (fortsaet laesning) 


2) Venstre knap pa musen svarer til det, der ville vaere affy- 
ringsknappen pa joystikket. 

3) Den hajre knap pa musen svarer til det, der ville vaere OP ret- 
ning pa et joystik. 


Software interface 


1) Da venstre og hgjre knap virker som joystik-linier, er det en 
ubetydelig opgave af laese dem fra software i polling. Be- 
meerk at som med et joystik vil knapperne bryde ind i tastat- 
ur-mappen, og software bor gore forseg pa at skelne mel- 
lem et manglende punkt i tastatur-matrixen (d.v.s. en taste 
trykkes ned), og en hel raekke eller kolonne, der far startfor- 
bud (d.v.s. en form for joystik-signal). 


2) Positions-oplysningen er ikke svzer at klare. Den passer 
ideelt ind i 60 hz interrupt rutinen (fortrinsvis i begyndelsen 
— se afsnittes om SID REGISTER FORHOLDSREGLER). 
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Strategien er som falger: 
1) Lees muse-position MOD 64. 


2) Bestem om musen har beveeget sig ved at sammenligne 
den nuvzerende posion med en gemt kopi af den forrige po- 
sition. 

3) Hvis musen har bevaeget sig, sa modificer pointerens posi- 
tion tilsvarende. 


Musen forsgger et transmittere en position til CID registret. 
Uheldigvis er der en enkelt stoj-bit i transmissionen. Selv om 
musen er i ro, er det f.eks. muligt for POT registret at svinge 
mellem $ 80 og $ 70. Dette ville resultere i, at musens position 
dirrer mellem to punkter. 


Det er derfor nadvendigt at tage den lave order bit i POT regi- 
stret i betragtning, for der tages beslutning om, om musen har 
bevaeget sig. Al dette kan ses i den leverede muse-driver- 
code. 


SID register forholdsregler 


|C 64 og C 128 er SID pot linierne forbundet til begge joystik- 
porte. En 4066 analog switch bruges til at switche POT linierne 
mellem de to porte, baseret pa en af tastatur skanne-linierne. 
Dette betyder, at den normale tastatur-skanne-interrupt nu og 
da har pavirket de veerdier, der returneresi POT registrene. For 
at give troveerdig konvertering skal POT linierne derfor forbin- 
des til musen i en periode af > 1.6 ms, for den veerdi, der retur- 
neres til POT registret, geelder. 


Den bedste made at sikre dette pa, er at indsaette softwarentil 
muse-driveren i IRQ handleren forud for det pollede tastatur- 
scan. Dette sikrer mere eller mindre, at tastatur-skan-linierne 
er tilstreekkeligt stabile, for POT registret laeses af muse-driver 
ne. 
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Kort om denna manual 


| huvudsak bestar denna manual av tva delar. Den férsta delen 
bestar av en introduktion och allmanna rad for handhavande 
av 1351 Mus. Denna del ar for anvandare som har programva- 
ra avsedd for musstryning. Den andra delen innehaller infor- 
mation for dem som ar intresserade att skriva egna applikatio- 
ner. 


Introduktion 


Commodore 1351 Mus ar framtagen fér att anvandas tillsam- 
mans med Commodore 64 och Commodore 128. Den har tva 
sk arbetslagen, dels som Joystick och dels som mus. 


| joysticklage imiterar musen en Joystick och kan anvandas till- 
sammans med program som ar gjorda for att styras av en Joy- 
stick. | detta lage anvands den vanstra knappen pa samma 
satt som knappen pa en Joystick och den hégra knappen har 
ingen funktion. For att initiera joysticklage, anslut musen i joy- 
stickport 1 eller joystickport 2 i enlighet med de instuktioner 
som anges i det program som skall anvandas, innan str6mmen 
slas pa till datorn. Hall sedan héger knapp pa musen nedtryckt 
och sla pa strommen till datorn. Nu befinner man sig i joystick- 
lage. 


| sitt andra lage anvander musen en ny teknik f6r proportionell 
rorelse, som medger snabba och smidiga férlyttningar 6ver 
skarmen. Detta kraver att det program man avser att anvanda 
har en drivrutin for mus. Aldre program saknar denna drivrutin 
och man far da anvanda musen i joysticklage enligt ovan. 
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RengGring 

For att musen skall svara snabbt pa de rérelser man g6r, kravs 
det att kulan snurrar fritt och obehindrat. Darfor at det viktigt att 
halla den ren fran smuts och skrap. Tag for vana att med jamna 
mellanrum plocka ut kulan och torka. den ren med en mjuk tra- 
sa. Se fig. 


Gor rent utrymmet dar kulan ligger genom att blasa bort ev 
skrap. | detta utrymme finns tre metallrullar som kan reng6ras 
med en bomullstopp fuktad med ren alkohol. Lagg darefter till- 
baka kulan och tryck fast bottenpilattan. 
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Introduktion 


Detta ar en kortfattad handledning som avser att ge grundlag- 
gande information for dem som 6nskar anvanda musen i egna 
applikationer. Som tidigare namnts finns det tva grundlaggan- 
de tekniker som kan anvandas vid styrning med hjalp av mu- 
sen, namligen: 

1) Joysticklage 

2) Proportionell forflyttning 

Proportionell forflyttning kan anvandas bade till Commodore 
64 och Commodore 128, och anvander en speciell drivrutin | 
maskinkod for optimal funktion. Vilket lage som anvands 
bestams vid uppstart. Om hdéger knapp pa musen halls ned- 
tryckt vid uppstart kommer man att hamna i joystickiage, i an- 
nat fall hamnar man automatiskt i det proportionella laget. Av- 
sikten med att tillhandahalla Joysticklaget ar att medge an- 
vandning av musen aven i program som inte inehaller en spe- 
ciell drivrutin for proportionell styrning. 


Joysticklage 

1) Om en férflyttning av musen sker aktiveras en joysticksignal 
under 20 ms i motsvarande riktning. 

2) Den vanstra knappen ar definierad att motsvara aktiverings- 
knappen pa en joystick. 

3) Den hégra knappen ar definierad i SID POTX registret. Om 
hdéger knapp ar nedtryckt kommer SID POTX registret att in- 
nehalla ett varde <$ 80. Om knappen inte ar nedtryckt 
kommer registret att innehalla ett varde >= $ 80. 


Se ocksa anmarkning under rubriken SID REGISTER. For 
de flesta aplikationer anvander man en standard drivrutin 
for joystick och lamnar hdger knapp odefinierad. 
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Proportionell férflyttning 
Funktionerna i proportionellt lage ar féljande: 


1) Rorelser registreras internt. Musens position MOD 64 éver- 
fors till SID POTX och POTY registren med intervall 512 us., 
automatiskt. 


POTX registret laser av x-koordinaten fér musens position 
och POTY laser av y-koordinaten. 


Registrets innehall ser ut pa féljande satt: 


Figur: 1716/5/4[3/2[1/0 
X |P5|P4/P3/P2/P1|PO| N | 


dar: 
: ene a Cree ej signifikant bit. 
P5-PO) socivieies ar musens position MOD 64. 
Nahata ar en speciell (noise) bit (fortsatt las) 


2) Vanster knapp ar definierad pa samma satt som aktive- 
ringsknappen pa en joystick. 


3) Hdger knapp ar definierad som position UPP paen joystick. 


Mjukvaruanpassning 


1) Da vanster och héger knapp motsvaras av joystickvarden, 
anvander man en motsvarande avkanningsrutin for att asa 
av respektive varde. 


Notera att det ar lampligt att forsdka fa programmet att sars- 
kilja en tangenttryckning resp da en rad eller kolumn aktiver- 
as (dvs en joystickliknande signal). 


2) Positionsangivelserna hanteras lamligen av en 50 Hz inter- 
rupt rutin (forslagsvis placeras denna rutin i bérjan, se ock- 
sa under rubrik SID REGISTER). 
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Foérslag: 
1) Las av muspositionen MOD 64 


2) Bestam om musen har flyttats genom att jamfora nuvaranda 
position med en sparad angivelse av foregaende position. 


3) Om musen har flyttats, modifiere markérens position. 


Musen forsoker att sanda sitt lage till SID-registret. Tyvarr 
finns deten viss stérning i 6verféringen. Detta betyder bland 
annat att Aven om musen ligger still kan det vara sa att POT- 
registret svanger mellan $ 80 och $ 70. Detta skulle resul- 
tera i att muslaget hoppar mellan tva punkter. 


Darfér ar det nédvandigt att ta hansyn till den laga biten i 
POT-registret innan man bestammer om musens lage har 
andrats. 


Var uppmarksam pa detta i SID-registret: 


1C 64 0chC 128 ar SID pot-linjerna anslutna till bada joystick- 
portarna. En 4066 analog omkopplare anvands for att koppla 
om mellan de tva portarna baserat pa en av tangentbordets 
scan linjer. Detta betyder att de normala tangent-scan avbrot- 
tet (interrupt) tillfalligt paverkar de varden som skickas till POT- 
registren. For att fa tillférlitliga varden maste POT-linjerna dar- 
for vara anslutna till musen minst 1.6 ms innan vardena i POT- 
registret ar korrekt. 


Det basta sattet att forsakra sig om att detta sker ar att fora in 
mushanteringsmjukvaran fore tangentscanningen i IRQ-han- 
teraren. Gér man detta kan man vara mer eller mindre saker pa 
att tangent-scanlinjerna ar tillrackligt stabila innan POT-regi- 
stret lases av musdrivrutinen. 
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BASIC AND MACHINE 
LANGUAGE PROGRAMS 
FOR 1351 MOUSE 
AND C64 


GOSUB140:GOSUB330 


V = 13*4096:POKEV + 21,1:POKEV + 39,1:POKEV + 
0,100:POKEV + 1,100:POKEV + 16,0 


POKE2040,56:SYS12+4096 + 256 
END 


FORX = 0T0129:READA$:GOSUB430:POKE49408 + X,Y:NEXTX: 


RETURN 

DATAAD, 15,03,C9,C1,F0,19,08 
DATA78,AD,14,03,8D,00C0,AD 
DATA15,03,8D,01,C0,A9,21,8D 
DATA14,03,A9,C1,8D, 15,03,28 
DATA60,D8,AD,19,D4,AC,02,CO 
DATA20,58,C1,8C,02,C0,18,6D 
DATA00,D0,8D,00,D0,8A,69,00 
DATA29,01,4D,10,D0,8D,10,D0 
DATAAD,1A,D4,AC,03,C0,20,58 
DATAC1,8C,03,C0,38,49,FF,6D 
DATA01,D0,8D,01,D0,6C,00,CO 
DATA8C,05,C0,8D,04,C0,A2,00 
DATA38,ED,05,C0,29,7F,C9,40 
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280 
290 
300 
310 
320 
330 


340 
350 
360 
370 
380 
390 
400 
410 
420 
430 
440 


450 
460 


470 


DATABO,07,4A,F0,12,AC,04,CO 
DATA60,09,C0,C9FF,F0,08,38 
DATA6A,A2FF,AC,04,C0,60,A9 
DATAO00,60 


FORX = 0TO63:READA$:GOSUB430:POKE3584 + X,Y:NEXTX: 
RETRUN 

DATAF8,00,00,90,00,00,B8,00 

DATAO0,DC,00,00,8E,00,00,07 

DATA00,00,02,00,00,00,00,00 

DATA00,00,00,00,00,00,00,00 

DATA00,00,00,00,00,00,00,00 

DATAO00,00,00,00,00,00,00,00 

DATAO0,00,00,00,00,00,00,00 

DATAO00,00,00,00,00,00,00,00 


Y=1:Y1=0 | 
IFLEFTS(A$,1) < >MID$(‘‘0123456789ABCDEF”,Y, 1) 
THENY =Y + 1:GOTO440 

Y¥1=(Y-1)#16:Y =1 

IFRIGHTS(A$,1) < > MID$(“0123456789ABCDEF”,Y,1) 
THENY = Y + 1:GOTO460 

Y=Y14 Y-1:RETURN 


READY. 
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BASIC AND MACHINE 
LANGUAGE PROGRAMS 
FOR 1351 MOUSE 
AND C128 


GOSUB230:GOSUB420:SYS6144. 

BA = DEC(“‘0A04’’):POKE VA, 1ORPEEK(BA) 
SPRITE 1,1,2:MOVSPR 1,100,100 
GRAPHIC1,1:CHAR 1,8,1,“1351 MOUSE PAINT” 
DO:IF (JOY(1) AND 128) THEN GOSUB 180 

IF (JOY(1) AND 1) THEN GRAPHIC 1,1:CHAR 1,8,1, 
“1351 MOUSE PAINT” 

LOOP 

X = RSPROS(1,0)—25:Y = RSPPOS(1,1)—51: 

X= —X«(X>0):Y= —Y+(Y>0) 

LOCATE X,Y:C = 1-RDOT(2):DRAW C,x,Y 

DO:X = RSPOS(1,0)—25:Y = RSPPOS(1,1)—51: 

X= —X+#(X>0):¥Y = —Y(Y>0) 

DRAW C TO X, Y:LOOP WHILE JOY(1) AND 128 : RETURN 


FORX = 0T0135:READA$:POKE6144 + X,DEC(A$):NEXTX: 
RETURN 

DATAAD,15,03,C9, 18, F0,19,08 
DATA78,AD,14,03,8D,F0,18,AD 
DATA15,03,8D,F1,18,A9,21,8D 

DATA14,03,A9,18,8D, 15,03,28 


280 DATA60,D8,AD,7E,11,D0,33,AD 
290 DATA19,D4,AC,F2,18,20,5D,18 
300 DATAS8C,F2,18,18,6D,D6,11,8D 
310 DATAD6,11,8A,69,00,29,01,4D 
320 DATAE6,11,8D,E6,11,AD,1A,D4 
330 DATAAC,F3,18,20,5D,18,8C,F3 
340 DATA18,38,49,FF,6D,D7,11,8D 
350 DATAD7,11,6C,FO0,18,8C,F5,18 
360 DATA8D,F4,18,A2,00,38,ED,F5 
370 DATA18,29,7F,C9,40,B0,07,4A 
380 DATAFO,12,AC,F4,18,60,09,CO 
390 DATAC9,FF,F0,08,38,6A,A2,FF 
400 DATAAC,F4,18,60,A9,00,60,00 
AAO! REM 2ss-Scenees ence 


420 FORX = 0TO63:READA$POKEDEC(‘‘0E00””) + X,DEC(A$):NEXTX: 
RETURN 
430 DATAF8,00,00,90,00,00,B8,00 
440 DATAOO,DC,00,00,8E,00,00,07 
450 DATAO00,00,02,00,00,00,00,00 
460 DATAO0,00,00,00,00,00,00,00 
470 DATAO00,00,00,00,00,00,00,00 
480 DATA00,00,00,00,00,00,00,00 
490 DATAOO,00,00,00,00,00,00,00 
500 DATA00,00,00,00,00,00,00,00 | 


88& 


dud 


L+,= 
L+.,= 
b+,= 
L+. 
e+. 


OLS = 
uolsod x sepso yBiy stQ vq: 


aBew! 13181692 o1a yo Adoo s,o1seq | 
e6ew! 13}8/5a1 o10 yo Adoo s,a1seq : 


ayds aaow uay) ‘osaz YI! 


sy 
did 


4+bsy eqs 


bay eqs 
baw < # ep] 


L+zbiy es 
bay ep) 
res 


$06 baq 
buw<¥# dwo 


$06 


buw<¥# ep 


b+ bay epy jjeysuy 


oost$ =. 


OLS + ByEpaia 
00$ + ByEpPoia 
SPLLS 


I 


OZLL$ 


eI$ + pis 
61S + pis 
OOrP$ 
Ooops 
vicos 


t 


" 


SuoNeoudde O'2 DIS 10) seAUp asnow gz1/9 


EO nN eee nee 


_anjeapjo 
anjeamau 
Ayodo 
xjodo 


ebay 


qswsodx 
sodA 
eepoia 


aaoe 


Ayod 
xjod 
PIs 
OIA 
bay 


09 
8% 


sieo as 
Bl 6V 
vito ag 
bz 6V 


+38! 08 
vleo OV 
BZ 
80 


61 04 
81 60 
Sl€0 av 


0081 = 


9481 = 

Sash 
vel = 
€481 = 
c48L = 


0381 = 


93h = 
Zar = 
9aLL = 


32Zbb= 


viva = 
6LyQ = 
00va = 
0000 = 
rleo= 


ozeL 
Stee 


Orel 
viel 
2U8L 
SL8L 


o08t 
6081 


g08l 
2081 


sosl 
eogt 
ooet 


S48l 
vst 
east 
e48l 
0581 


8&9 


uoljesado bit sm anutjUod * 


(jod ul aseasour soy A aseaioap) uo!ysod A Ayipow : 


A 10} anjea eyep 3a6 : 


uoljyIsod x Jap10 Mo] Ayypow * 


X 20} SaNjea eyap 126 ¢ 

(j you Aym) }! aaey dIseq 33} : 
ayuds Bulaow si dIseq jt: 
“vgseo ul isnl: 


(ban) dul 


sodA e}s 
sodd ope 


d3S# 109 
29s 


Ayodo As 
yyoaow 4st 
Ayodo Ap} 
Ayod ep 


qsusodx e)s 
qswsodx 109 
L0000000%# Pue 
O0$S# Ope 

ex} 

sodx eS 

sodx ope 

919 


xjodo Ajs 
yyoaou ssf 
xyodo Apj 
xjod ep] 
$06 9uq 
9aljoe ep} 
PI? 


$06 


burw 


eZ 
ol 
ba 
OL 
69 
89 
29 
99 
So 
ia) 
eo 
co 
19 
og 
6S 
8S 
2g 
9S 
Ss 
9S 
es 
es 
1S 
os 
6b 
gy 
2v 
id 
Sv 


0381 09 


2att ag 
Z2qbt ag 
dd 6y 
ge 


ess O8 
asel 02 
dsl OV 
virg av 


93ll a8 
93tl Or 
LO 62 
00 69 
vg 

galt a8 
galt ag 
gh 


Zd8L XB 
aset 02 
c48t OV 
6tvd av 
ee 00 
att av 
ie) 


VvSel 


2S8t 
ySBt 
cost 
1S8t 


vet 
arst 
8r8l 
Syet 


evel 
Aceh 
QeBt 
geek 
vest 
2€8t 
vest 
eest 


oest 
azel 
Vv2el 
2e8L 
Szel 
eee 
Lzgl 


90 


anyea pio = Am uinyel 


Q=>e 
uinyad 
anjeameau = > A 
| =>x 
qe=>e 
<> , 4! 
$}Iq Japso YyBiy ul 10 asa 
usnjas 
anjeamau = > A 
0<> J! 
gge =>e 
o< i 


( pjo-mau )pgpow => e 
0 /M X peojaud 


Saniea Mau % pO aAes 


uOol}ISOd 10} enjea eYJap = et 
ANJEA Plo 410} ASN O} aN|eA 
19381631 yod yo anyjea juauNS 
49}8169) 10d jo anjea pjo 


su 
O# BPI $o8 


sy 

anjeamau Ap} 

HSH XPI 

e102 

28s 

$og beq 

y$# dwo 
0000001 | %# B40 $0S 


su 
anjeamau Ap} 

$08 beq 

es} 

$0¢ Soq 

00000010%# dw 

LLELLLLO%# Pue 
anjeaplo oqs 

20s 


O# API 
@NjPAMAL BYS 
anyeaplo As yYYOAOW 


I 


x 

A wxe : 

e : 

A Aiyua : 
MHOAON : 


vol 
col 
ZOL 
LOL 
OoL 


09 
00 6V 


09 

bj8l OV 
dd 2V 
v9 

ge 

80 04 
dd 69 
09 60 


09 

vist OV 
zt OA 
vw 
20.08 
Or 69 
Ad 62 


$48+ Q3 
ge 


98 
00 2v 
vist as 
SA8l O8 


9ge8L 
veel 


eset 
osel 
aZet 
azeL 
Ooze 
vzel 


8Z8L 
9281 


S28b 
z2e8t 
0281 
4981 
aget 
ggst 
6981 
9981 
s9st 


£981 
0981 
ase} 
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Sty 


$LZ oz #51 ZglL= SOdA 


$L9 og #91 93bL= aSWsOdXx 

$9S GS #¥L 9OLL= SOdx 

QL St vi #EL 9aLL= VLVAOIA 
#9 000d = SIA 

6 8 #2 00rd = als 

€9 #6 vira= ALOd 

6r #8 6L ra = XLOd 

$99 v9 #2~ e48t ALOdO 

$zS os #1e Z381 XLOdO 

98 $18 #9 Ssh aMVAdI10 

LOL 6 $28 HET vigsl SM1IVAMAN 
#18 so LS aseL WHOAOW 

#OD ov ge 6c keel DYIW 
#82 00st TIVISNI 

eZ SOE SVE #02 o348t z0ull 
$6E se ee 82 #S vLEO= Dull 
dv #tt B2bb= BAILOV 

SSOUSIBjoY anjeaA joquAs 


(pesy = <yOVTa> ‘alum = $ ‘uoIUeag = #) sBely aouaJajoy 


» « BOUTIBJOY SSOID .. 
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1351 MOUS PIN-OUT. 


CONNECTION TABLE 
FUNCTION 
| PINNO. | JOYSTICK MODE PROPORTIONAL MODE 


DOWN UNUSED 
LEFT UNUSED 


RIGHT UNUSED 


ae 
7 


Ese] 
cm 


RIGHT BUTTON X-POSITION 
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C= Commodore 
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